home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / hp48hor2 / awari.doc < prev    next >
Text File  |  1995-03-31  |  6KB  |  117 lines

  1.  
  2.                                AWARI 1.1 
  3.                              For the HP48sx 
  4.  
  5.                              By Garth Sweet 
  6.                           Copyright Jan. 1993 
  7.  
  8.         AWARI is a game based on the ancient African game of the same 
  9. name, it was originally played on a wood or stone board made with 14 
  10. holes or 'buckets' in it. In 12 of the buckets were placed 36 stones (3 
  11. per bucket), the idea of the game was to move stones from the 12 filled 
  12. buckets to your home bucket (one of the 2 empty ones). 
  13.  
  14.         AWARI for the HP48 replaces the wooden board and 36 stones with 
  15. the LCD screen, the board is drawn out onscreen as it wouldv'e appeared 
  16. in wood. Below is a simple ASCII representation of the board, to try and 
  17. show how the board is laid out. 
  18.  
  19.           /---\    /---\    /---\    /---\    /---\    /---\ 
  20.          |  3  |  |  3  |  |  3  |  |  3  |  |  3  |  |  3  | 
  21.   /---\   \---/    \---/    \---/    \---/    \---/    \---/   /---\ 
  22.  |     |                                                      |     | 
  23.  |  0  |    A        B        C        D        E        F    |  0  | 
  24.  |     |                                                      |     | 
  25.   \---/   /---\    /---\    /---\    /---\    /---\    /---\   \---/ 
  26.          |  3  |  |  3  |  |  3  |  |  3  |  |  3  |  |  3  | 
  27.           \---/    \---/    \---/    \---/    \---/    \---/ 
  28.  
  29. The game requires two players, (although the HP48 can play one of them) 
  30. and each player gets one row of buckets plus an end bucket as thier own. 
  31. Player 1 gets the top row plus the leftmost bucket, player 2 gets the 
  32. bottom row plus the rightmost bucket. 
  33.  
  34.         To play, a player selects a bucket (by pressing a key A-F) and 
  35. the computer will take all the stones from that bucket, and place one 
  36. in the bucket next to it, then one in the next, and so on until there 
  37. are no more stones to drop (play moves counterclockwise). Each bucket 
  38. originally starts out with 3 stones in it, and the home's have none. 
  39. If for instance then player 1's 1st move was to move the stones from 
  40. bucket B (which would contain 3 stones). Then after selecting B, the HP 
  41. will add 1 stone to A (making 4 in A), 1 stone to home (making 1 in 
  42. home) and add wrap around and add one to player 2's A bucket (making 4 
  43. in player 2's A bucket). The idea is to get as many stones into your 
  44. home bucket this way as possible, the game ends when any player can't 
  45. play (thier side is out of stones) or any buckets has more then 18 
  46. stones (at that point someone has more then half the available stones so 
  47. they are guaranteed the win). But there are also a couple of other rules 
  48. to add a twist to the game, the 1st is that when a player is taking a 
  49. turn, if they make a move that results in the last stone being dropped 
  50. into thier own home, they get to go again (but only once per turn). The 
  51. 2nd rule is that if the last stone being dropped is going into an empty 
  52. bucket, and there are stones in the bucket immediately across from it, 
  53. then the one stone plus all the stones in the bucket across go to your 
  54. home. The rules are simple really, just play once or twice and you'll 
  55. have the idea. 
  56.  
  57.         AWARI comes in the form of a library, to set it up, do the 
  58. following: 
  59.  
  60. 1. Download the library to the home directory of the HP48 
  61.  
  62. 2. RCL the library to the stack ( 'AWARI' [RCL] ) 
  63.  
  64. 3. Type ':0:1160 [STO]' 
  65.  
  66. 4. Purge the AWARI library from the VAR menu ( 'AWARI' [PURGE] ) 
  67.  
  68. 5. Turn the HP off and then on. 
  69.  
  70. When you go to the library menu, there should be an AWARI directory 
  71. there, go to that directory and select AWARI. 
  72.  
  73.         AWARI takes up about 6K of memory, and is written in User RPL, 
  74. this makes it a little slow, perhaps, but not really, it's quite fast. 
  75. There are also two utilties that the library uses, and make be useful 
  76. to you aswell, they are GETS and PUTS, they work EXACTLY like GETI and 
  77. PUTI only they don't increment the counter, this means that after a PUT 
  78. you still have the counter on that stack of where you did the PUT at. 
  79. The two utilties will be useable in any program you write, so long as 
  80. the library is attached. Enjoy! 
  81.  
  82. CHANGES TO 1.1: 
  83.   - Pressing the BACKSPACE key will switch AWARI into an 'auto finish' 
  84.     mode, the HP48 will automatically make the best (most point gaining) 
  85.     move for each player. This makes it nice for when you can tell who's 
  86.     going to win and don't want to go through the motions. 
  87.   - Pressing ATTN to exit cleans up the stack completly. 
  88.   - On ending AWARI leaves you in the LIB menu, not the VAR menu. 
  89.   - Fixed virtually un-noticed key bug. 
  90.   - Made game board symetrical. (Oops!) 
  91.  
  92. Notes: This is the 1st library I've released, and while it works well 
  93.        on my HP, I can't guarantee it at all for anyone else's. In 
  94.        particular, I don't know if the library ID I picked is already 
  95.        used by another program in circulation.  If anyone has any 
  96.        problems I would certainly be glad to hear of them, I'd like to 
  97.        make sure the program is fully bug-free. This software is 
  98.        released as use at your own risk. This program is released into 
  99.        the Public Domain and is free to use and copy. 
  100.  
  101.                        How to contact the author: 
  102.  
  103.                                  Write: 
  104.  
  105.                               Garth Sweet 
  106.                         Comp. 34, Mayflower Ave. 
  107.                           Lr. Sackville, N.S. 
  108.                                 B4C 2S6 
  109.                                  Canada 
  110.  
  111.  
  112.                                  Phone: 
  113.                               902-865-8987 
  114.  
  115.                                  Email: 
  116.                            sweet@ug.cs.dal.ca 
  117.